home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3n / getnetconfig.z / getnetconfig
Encoding:
Text File  |  2002-10-03  |  8.4 KB  |  130 lines
  1.  
  2.  
  3.  
  4. ggggeeeettttnnnneeeettttccccoooonnnnffffiiiigggg((((3333NNNN))))                                              ggggeeeettttnnnneeeettttccccoooonnnnffffiiiigggg((((3333NNNN))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _gggg_eeee_tttt_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg - get network configuration database entry
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg_...._hhhh_>>>>
  13.      _vvvv_oooo_iiii_dddd _****_ssss_eeee_tttt_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg_((((_vvvv_oooo_iiii_dddd_))))_;;;;
  14.      _ssss_tttt_rrrr_uuuu_cccc_tttt _nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg _****_gggg_eeee_tttt_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg_((((_vvvv_oooo_iiii_dddd _****_hhhh_aaaa_nnnn_dddd_llll_eeee_pppp_))))_;;;;
  15.      _iiii_nnnn_tttt _eeee_nnnn_dddd_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg_((((_vvvv_oooo_iiii_dddd _****_hhhh_aaaa_nnnn_dddd_llll_eeee_pppp_))))_;;;;
  16.      _ssss_tttt_rrrr_uuuu_cccc_tttt _nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg _****_gggg_eeee_tttt_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg_eeee_nnnn_tttt_((((_cccc_hhhh_aaaa_rrrr _****_nnnn_eeee_tttt_iiii_dddd_))))_;;;;
  17.      _vvvv_oooo_iiii_dddd _ffff_rrrr_eeee_eeee_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg_eeee_nnnn_tttt_((((_ssss_tttt_rrrr_uuuu_cccc_tttt _nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg _****_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg_pppp_))))_;;;;
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      The five library routines described on this page are part of the UNIX
  21.      System V Network Selection component.  They provide application access to
  22.      the system network configuration database, _////_eeee_tttt_cccc_////_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg.  In addition
  23.      to the _nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg database and the routines for accessing it, Network
  24.      Selection includes the environment variable _NNNN_EEEE_TTTT_PPPP_AAAA_TTTT_HHHH [see _eeee_nnnn_vvvv_iiii_rrrr_oooo_nnnn(5)] and
  25.      the _NNNN_EEEE_TTTT_PPPP_AAAA_TTTT_HHHH access routines described in _gggg_eeee_tttt_nnnn_eeee_tttt_pppp_aaaa_tttt_hhhh(3N).
  26.  
  27.      A call to _ssss_eeee_tttt_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg has the effect of ``binding'' or ``rewinding'' the
  28.      _nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg database.  _ssss_eeee_tttt_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg must be called before the first call to
  29.      _gggg_eeee_tttt_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg and may be called at any other time.  _ssss_eeee_tttt_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg need _n_o_t
  30.      be called before a call to _gggg_eeee_tttt_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg_eeee_nnnn_tttt.  _ssss_eeee_tttt_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg returns a
  31.      unique handle to be used by _gggg_eeee_tttt_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg.
  32.  
  33.      When first called, _gggg_eeee_tttt_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg returns a pointer to the current entry in
  34.      the _nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg database, formatted as a _nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg structure.  _gggg_eeee_tttt_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg
  35.      can thus be used to search the entire _nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg file.  _gggg_eeee_tttt_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg
  36.      returns _NNNN_UUUU_LLLL_LLLL at end of file.
  37.  
  38.      _eeee_nnnn_dddd_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg should be called when processing is complete to release
  39.      resources for reuse.  Programmers should be aware, however, that the last
  40.      call to _eeee_nnnn_dddd_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg frees all memory allocated by _gggg_eeee_tttt_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg for the
  41.      _ssss_tttt_rrrr_uuuu_cccc_tttt _nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg data structure.  _eeee_nnnn_dddd_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg may not be called before
  42.      _ssss_eeee_tttt_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg.  _eeee_nnnn_dddd_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg returns _0000 on success and _----_1111 on failure (for
  43.      example, if _ssss_eeee_tttt_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg was not called previously).
  44.  
  45.      _gggg_eeee_tttt_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg_eeee_nnnn_tttt returns a pointer to the _nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg structure
  46.      corresponding to _n_e_t_i_d.  It returns _NNNN_UUUU_LLLL_LLLL if _n_e_t_i_d is invalid (that is,
  47.      does not name an entry in the _nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg database).  It returns _NNNN_UUUU_LLLL_LLLL and
  48.      sets _e_r_r_n_o in case of failure (e.g., if _ssss_eeee_tttt_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg was not called
  49.      previously).
  50.  
  51.      _ffff_rrrr_eeee_eeee_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg_eeee_nnnn_tttt frees the netconfig structure pointed to by _n_e_t_c_o_n_f_i_g_p,
  52.      previously returned by _gggg_eeee_tttt_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg_eeee_nnnn_tttt.
  53.  
  54.  
  55.  
  56.  
  58.  
  59.  
  60.                                                                         PPPPaaaaggggeeee 1111
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67. ggggeeeettttnnnneeeettttccccoooonnnnffffiiiigggg((((3333NNNN))))                                              ggggeeeettttnnnneeeettttccccoooonnnnffffiiiigggg((((3333NNNN))))
  68.  
  69.  
  70.  
  71. SEE ALSO
  72.      _nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg(4), _gggg_eeee_tttt_nnnn_eeee_tttt_pppp_aaaa_tttt_hhhh(3N), _eeee_nnnn_vvvv_iiii_rrrr_oooo_nnnn(5)
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.                                                                         PPPPaaaaggggeeee 2222
  127.  
  128.  
  129.  
  130.